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When developing code to operate a real-time clock (RTC), it is often beneficial to understand how the clock core operating logic has been defined. We all have a fundamental 
comprehension of how a clock and calendar should operate when properly programmed, but insight into the expected chip behavior if improper or illegal contents are somehow 
installed also is helpful. The software must ensure the proper values are written to the chip. 



RTC counter chains can be found in many BCD-formatted (binary-coded decimal) RTCs (Fig. l). Each counter register has defined minimum and maximum values, and most are 
preset to their appropriate minimums on initial power application. 



Leap year? 



Seconds 




Mil Mil '. 







J L I 



Moniti 











4- Day 



l. Basic RTC counter chains can be found in many BCD-formatted RTCs. 



As a natural function of timekeeping, when the seconds count reaches the maximum value, the next increment causes a carry to the minutes register and the seconds rolls over to the 
minimum value. A minutes rollover carries to the hours. The hours rollover carries to both the date and arbitrary day-of-week registers. The date rollover carries to the month 
register. The month rollover carries to the year register. 

If applicable, the year rollover carries to the century register. Some variations on the counter implementation may include a "hundredths of a second" register (precedes seconds) 
and a century bit to flag the year register rollover (Table l). 
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Register Descriptions 

For each register, the normal state machine logic is to increment the BCD count from the minimum to the defined maximum and then roll back over to the minimum while applying 
the carry to the next register. For an example, the date register BCD count sequence for a 30-day month would be oih...09h, ioh...i9h, 2oh...29h, 30I1, and then roll back to oih. The 
ramifications of loading improper values are based upon the specific component and which register(s) was actually involved. Illogical time and date entries may result in unexpected 
operation. 

The hundredths of a second register (if applicable) counts from ooh to 99I1. The next increment causes the counter to roll over to ooh, and the carry is applied to the seconds 
register. All 8 bits in this register are read/write capable. Devices containing this register are internally clocked from the 4-kHz time base (32.768 kHz/8). 

The seconds register counts from ooh to 59I1. The next increment causes the counter to roll over to ooh, and the carry is applied to the minutes register. Only the least significant 7 
bits in this register are usually read/ write capable. Most devices that don't have a hundredths of a second register are internally clocked from the l-Hz time base. 

The minutes register also counts from ooh to 59I1. The next increment causes the counter to roll over to ooh, and the carry is applied to the hours register. Only the least significant 7 
bits in this register are read/write capable. 

The hours register accommodates either a 12-hour format (with an AM/PM designator) or a 24-hour clock. A control bit (usually bit6) is used to identify the clock operating mode. 
Only the least significant 7 bits in the hours register are read/write capable. In the 24-hour mode (bit6 = o), the hours register counts from ooh to 23I1. The next increment causes 
the counter to roll over to ooh, and the carry is applied to both the date and day registers. 



://electronicdesignxom/prin^^ 23/08/2012 



Real-Time Clock Programming Requires Caveats 



Page 2 of 3 



In the 12-hour mode (bit6 = l), the hours register count sequence, starting at "12AM," counts 52I1, 4th... 49I1, 50I1, and then 5th. The next increment causes the counter to roll over to 
72h with the carry applied to the /AM/ /PM bit (PM = 1). The register then counts 72I1, 6ih...69h, joh, jih. The next increment causes the counter to roll over to 52I1 as PM is cleared, 
with the carry applied to both the date and day registers. For clarification, midnight is 12:00:00 AM and noon is 12:00:00 PM. 

The day (day-of-week) register is the most simplistic counter, with an intended content of Oih to 07I1. The next increment causes the counter to roll over to Oih with no carry. Should 
a user accidentally deposit a ooh content into this register, there is no adverse effect upon the other timekeeping registers, but the first week of clock operation will have eight days 
(0-7). 

The day register only has three functioning bits. So even though it initially seems impossible for the user to load a value greater than 7, any hex value greater than 7 written would 
store the bad value logic-ORd with the three functioning bits (07I1) (e.g., writing lFh would store a 07I1, or writing F5I1 would store a 05I1). Normal calendar convention is to define 
Sunday = 1, but that definition is arbitrary and fully under the user's control. 

The date register counts from oih to the definedend of the present month. The end of the month depends upon the present month and year content (in the case of February). Only 
the least significant 6 bits in the date register are read/write capable (Table 2). 
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The month register counts from oih to I2h. The next increment causes the counter to roll over to oih, and the carry is applied to the year register. To address Y2K issues in the late 
20th century, a century bit was included in the most significant bit (MSB) of the month register on components that did not include a full 8-bit century register. 

This century bit facilitated easy detection of the century change, as the bit changes state upon a year register rollover from 99I1 to ooh. Care should be taken when loading new 
calendar values to avoid corrupting the century bit logic condition. Please refer to the register map for the specific component in question. Conventional register placement leaves 
bits 7 and 4:0 as read/write capable. 

The year register counts from ooh to 99I1. The next increment causes the counter to roll over to ooh. The carry is applied to either the century register or the century bit, whichever is 
applicable to the component in question. All 8 bits in this register are read/write capable. 

Leap year compensation is based upon the era of the specific chip design. Applicability is normally annotated on the cover page of that datasheet. For most chip designs that do not 
include a century register, the leap year compensation functions properly through 2099 and is assumed to be the result of: 

If MODULO (CALENDAR_YEAR/4) == o 

Due to the era of existing chip designs, many of today's RTC components with a century register apply the same algorithm solely upon on the content of the year register. Therefore, 
they will incorrectly designate 2100 as a leap year. The Maxim DS1347 RTC utilizes the full Gregorian algorithm to determine leap year adjustments for February (Fig. 2). The 
century register (if applicable) counts from ooh to 99I1. All 8 bits in this register are read/write capable. 
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2. Last date of month is affected by the month as well as the leap year status. 



Results When Illegal Data Is Written 

Up to this point, we have discussed the proper counting methods used by the RTC, given the legal range of values for the register in question. Occasionally a question may arise 
concerning expected counter behavior when improper values were initially installed. The answer is deterministic and only requires a copy of the component's register map to arrive 
at a conclusion. 

To access the result of loading an improper value, perform a logic AND of the written value with the write-enabled bits in the register in question. If the resulting content is less than 
the register's maximum counter value, the register should subsequently increment from that AND-ed value. Rollover will occur when the bit states in the register eventually coincide 
with the expected maximum value for that counter. The following examples highlight this effect. 

Example 1: Invalid Month 

The month register of a DS1337 serial RTC chip has a valid range from 1 to 12. The most significant bit is the century bit. The BCD month portion is 5 bits. 

Writing a value of 2Ah to the register will result in a value of oAh being stored in the register. This is an invalid BCD value. If the desired value was month 10 then the value should 
have been 30I1, resulting in a stored value of loh. Bit 6 is also set for both 2Ah and 30I1. This sets the chip into 12-hour mode. 

Example 2: Invalid Hour 

The hours register range of a DS1390 low-voltage RTC is based on whether the chip is running in 12- or 24-hour mode, but there are values that are invalid regardless of the mode. 
The hours register has a write mask or 7FI1. Writing a value of FFh will result in a stored value of 7FI1. This is invalid for both modes. 

Example 3: Invalid Hour Depending Upon Mode 

Writing a 38I1 into the hours register of a DS1341 low-current RTC results in the unchanged value being stored in the register since the 7FI1 mask is used regardless of mode. Now it 
turns out that this value is invalid for both modes because it is outside of the range noted in Table 1. It exceeds the 24-hour limit of 23I1 and is below the 41I1 for 12-hour mode. 

Example 4: Invalid Seconds 

Writing AAh into the seconds register of a DS1302 trickle-charge timekeeping chip causes a problem because this chip uses bit 7 for a clock halt function. This stops the clock so no 
time keeping occurs until the bit is set to o. In this case, the clock will be stopped and the value of 2Ah will be saved in the register. The actual value is really irrelevant since the clock 
will not start counting until bit 7 is reset, and this requires writing a new value into the register. 
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It is still possible to write an invalid seconds value while allowing the chip to handle its timekeeping duties. For example, a value of 6oh is a problem since it exceeds the register's 
limit of 59h or 59 minutes. 

Example 5: Invalid Date 

Writing 2Dh into the date register of a DS1338 serial RTC is problematic. The 6-bit mask (3FI1) for the register will allow the value to be stored but it exceeds the limit of 31I1, 
although this limit is month specific. The upper limit ranges from 28h to 31I1 depending upon the month and leap year. 

Conclusion 

By using published register information and the deterministic nature of the state machine logic, some behavioral traits resulting from errant programming can be recognized during 
the system debugging phase. This symptom recognition can reduce a product's time-to-market. 
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